using System.Collections.Generic;
using System.Threading.Tasks;
using JGSY.CMS.LowCode.Platform.Domain.Entities;

namespace JGSY.CMS.LowCode.Platform.Domain.Interfaces
{
    /// <summary>
    /// 工作流版本仓储接口
    /// 提供工作流版本的持久化操作和版本管理功能
    /// 继承基础仓储接口，扩展版本相关的专业操作
    /// </summary>
    public interface IWorkflowVersionRepository : IRepository<WorkflowVersion>
    {
        /// <summary>
        /// 获取指定工作流的所有版本
        /// </summary>
        /// <param name="workflowId">工作流标识符</param>
        /// <returns>工作流版本列表</returns>
        Task<List<WorkflowVersion>> GetVersionsAsync(long workflowId);
        
        /// <summary>
        /// 获取指定工作流的特定版本
        /// </summary>
        /// <param name="workflowId">工作流标识符</param>
        /// <param name="version">版本号</param>
        /// <returns>指定版本的工作流版本实体，如果不存在则返回null</returns>
        Task<WorkflowVersion?> GetVersionAsync(long workflowId, int version);
        
        /// <summary>
        /// 获取指定工作流的下一个版本号
        /// </summary>
        /// <param name="workflowId">工作流标识符</param>
        /// <returns>下一个可用的版本号</returns>
        Task<int> GetNextVersionNumberAsync(long workflowId);
    }
}
